MoveAxisContinuousAbsolute

命令控制的運動至指定的絕對位置，並以指定的速度結束。

語法

KsCommandStatus MoveAxisContinuousAbsolute(
     int Index,
     double Position,
     double Velocity,
     double EndVelocity,
     double Acceleration,
     double Deceleration,
     double Jerk,
     McDirection Direction,
     McBufferMode BufferMode
);

參數

Index [in]：軸索引。索引以零為起點；別名將影響此參數。

Position [in]：運動的命令位置，[秒] （正或負值）。

Velocity [in]：最大速度值，[單位/秒]。

EndVelocity [in]：最終速度值，為帶正負號的值，[秒]。

Acceleration [in]：加速度值，單位由 McProfileType 類型決定，為 [單位/秒²] 或 [秒]。

Deceleration [in]：減速度值，單位由 McProfileType 類型決定，為 [單位/秒²] 或 [秒]。

Jerk [in]：加加速度值，單位由 McProfileType 類型決定，為 [單位/秒³] 或 [秒]。

Direction [in]：軸移動的方向，請見 McDirection 類型。

BufferMode [in]：定義如何融合兩功能的速度，請見 McBufferMode 類型。

回傳值

返回 KsCommandStatus 結構。

備註

• 若到達命令位置且沒有新的運動命令放入緩衝區，則軸繼續以指定的 EndVelocity 運行。
• 若 EndVelocity 小於 Velocity，軸將在到達命令位置後使用 EndVelocity 運行； 若 EndVelocity 大於 Velocity，軸將使用 Velocity 運行。
• 如果在這些函式上使用了 BufferMode，則此函式可以由 MoveAxisAbsolute 和 MoveAxisVelocity 的組合替換。
• 當模數軸啟用時，模數值會套用至 Position 參數，軸將依據所設的 Direction 移動。
  例如，若模數值為 360，當 Direction 設定為：
  • mcShortestWay / mcCurrentDirection：軸會採用最短距離到達目標。若距離相同，軸將以正方向移動至目標。例如，若目前位置為 0，目標位置為 340，軸將移動 -20 到達目標位置，最終位置將為 340。
  • mcPositiveDirection：軸以正方向移動至目標。例如，若目前位置為 0，目標位置為 -20，軸將移動 340 到達目標位置。
  • mcNegativeDirection：軸以負方向移動至目標。例如，若目前位置為 0，目標位置為 20，軸將移動 -340 到達目標位置，最終位置將為 20。

範例

N/A

使用需求

	RT	Win32
最低支援版本	4.0	4.0
標頭檔	ksmotion.h	ksmotion.h
程式庫	KsApi_Rtss.lib	KsApi.lib

參見

MoveAxisAbsolute

MoveAxisContinuousRelative

MoveAxisVelocity